MacGames Sampler

home *** CD-ROM | disk | FTP | other *** search

/ MacGames Sampler / PHT MacGames Bundle.iso / MacSource Folder / Samples from the CD / Assembly / Mac68k / MANUAL / MAN10.DOC < prev next >

Wrap

Text File | 1985-08-11 | 10.3 KB | 461 lines | [TEXT/Anon]

MAC.68K SPACE SPACE SPACE PURPOSE To insert blank lines into the output listing. FORMAT SPACE linecount subhead SPACE linecount,minpage DESCRIPTION SPACE inserts linecount number of blank lines into an output listing. If a new page just began or if a page boundary is crossed while inserting blank lines, the insertion stops and no blank lines are put on the new page. The sub heading field in page heading line 2 is reset with the subhead value. The optional minpage parameter specifies the minimum number of lines that must be available on the current page after the SPACE takes effect. If there are less than minpage lines left a page eject is forced. The location field of SPACE is used as the new subheading field in the second line of the page heading. EXAMPLES SPACE 4 SUBR SPACE 4,10 -59- MAC.68K MAC.68K STEXT STEXT STEXT PURPOSE To specify a macro and symbol definition assembly. The object file is generated with a .STX file extension. FORMAT STEXT DESCRIPTION STEXT is an initialization directive. It must appear after the IDENT card but before any noninitialization operation codes. STEXT generates the .STX files used with INCLUDES. An STEXT assembly reduces symbol and macro definitions from text format to a MAC.68K table format. In this format the symbols and macros can be loaded considerably faster using INCLUDES than by loading them in text form with an INCLUDE. Local symbols ..0000 to ..FFFF, qualified symbols (see QUAL), and any symbols or macros defined by an INCLUDES are not written to the .STX file. DATA and BSS may not be used within an STEXT assembly. STOPDUP STOPDUP STOPDUP PURPOSE To cause early termination an ECHO or DUP. FORMAT STOPDUP DESCRIPTION STOPDUP terminates a DUP or ECHO block by setting the outstanding duplication count to zero. The current DUP/ECHO block finishes and any unfinished duplications are cancelled. MAC.68K -60- MAC.68K STRDEC STRDEC STRDEC PURPOSE To convert a value into a decimal STRING. FORMAT stringname STRDEC expression,len DESCRIPTION STRDEC converts expression into a decimal character string and assigns the string value to stringname. The decimal value may be any positive value less than 64K, and the character string will be 1 to 5 characters in length with leading zero suppression. The optional field len may be used to create a fixed length string with leading zero fill. EXAMPLE LEN SET LEN+1 LENS STRDEC LEN LENMSG DC.B 'LENGTH REACHED "LENS"' STRHEX STRHEX STRHEX PURPOSE To convert a value into a hex STRING. FORMAT stringname STRHEX expression,len DESCRIPTION STRHEX converts expression into a hex character string and assigns the string value to stringname. The character string will be 1 to 8 characters in length with leading zero suppression. The optional field len may be used to create a fixed length string with leading zero fill. EXAMPLE LEN SET LEN+1 LENS STRHEX LEN LENMSG DC.B 'LENGTH REACHED $"LENS"' -61- MAC.68K MAC.68K STRING STRING STRING PURPOSE To define a character string. FORMAT stringname STRING startchar,len,dstringd DESCRIPTION STRING defines or redefines a named character string that may be substituted into a source line when referenced by "stringname". The parameter startchar is an expression that specifies the starting character to use in the delimited string dstringd. The parameter len is an expression that specifies the length of the string. d is the string delimiter character and may be any character not occuring in the string other than & or ". If startchar is null or zero the micro name is assigned a null value. If len is null or zero or greater than the available string length, the actual string length is used. EXAMPLES AA STRING 1,,*ABCD* MOVE.L #'"AA"',D0 becomes MOVE.L #'ABCD',D0 BB STRING 1,,+"AA"EFGH+ DC.L 8H"BB" becomes DC.L 8HABCDEFGH CC STRING 1,1,@A1+TAG IFS EQ,*"CC"*@* becomes IFS EQ,*@*@* MAC.68K -62- MAC.68K STRLEN STRLEN STRLEN PURPOSE To determine a string length and set a redefinable symbol to that value. FORMAT symbol STRLEN stringname DESCRIPTION STRLEN sets the value of symbol to the current length in characters of stringname. If an error is encountered, symbol is not (re)defined. EXAMPLE SLEN MACROL NAME,P1 AA STRING 1,,*P1* NAME STRLEN AA ENDM BB SLEN A1 sets BB to 2 BB SLEN (A1) sets BB to 4 BB SLEN FOO-10 sets BB to 6 BB SLEN OOP*S sets BB to 3 (string delimiter * appears in parameter) -63- MAC.68K MAC.68K SUBTTL SUBTTL SUBTTL PURPOSE To set a program listing subtitle. FORMAT SUBTTL subtitle string DESCRIPTION SUBTTL sets the 32 character subtitle field in the optional line 2 of the page heading. The first TITLE or SUBTTL in the program also sets the 32 character title field in line 1 of the page heading. If listing is active, SUBTTL forces a new page. TEXT TEXT TEXT PURPOSE To change the assembly to the text segment. FORMAT TEXT DESCRIPTION TEXT changes the current assembly segment to the text segment. TITLE TITLE TITLE PURPOSE To set a program listing title. FORMAT TITLE title string DESCRIPTION TITLE sets the 32 character title field in line 1 of the page heading. MAC.68K -64- MAC.68K VFD VFD VFD PURPOSE To generate data in a user selected bit-width field. FORMAT VFD width1/expression symbol VFD width1/expression,width2/expression,... DESCRIPTION VFD generates data within fields of 1 to 32 bits. If the value of the expression does not fit within the field the result is truncated and a source line error type 7 occurs. VFD is the only data or CPU operation code not automatically forced to an even byte or word boundary. VFD bit fields are packed left to right within a byte and may straddle a byte boundary. Use of the optional symbol field advances the assembler to the next byte boundary before processing the first bit field. EXAMPLES TABLE VFD 3/TYPE,15/L*A* VFD 1/0 VFD 4/FOO-3,9/BAZ,23/ADDR-TABLE -65- MAC.68K -65-